home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1993…ch: Other People's Memory / ADC Developer CD (1993-03) (''Other People's Memory'')_iso / Dev.CD Mar 93.iso / Development Platforms / Apple II / Essentials / APW Interfaces / CInclude / Locator.h < prev    next >
Encoding:
C/C++ Source or Header  |  1992-03-04  |  5.1 KB  |  158 lines  |  [TEXT/MPS ]
  1. /********************************************
  2. ; File: Locator.h
  3. ;
  4. ;
  5. ; Copyright Apple Computer, Inc.1986-92
  6. ; All Rights Reserved
  7. ;
  8. ********************************************/
  9. #ifndef __TYPES__
  10. #include <TYPES.h>
  11. #endif
  12.  
  13. #ifndef __LOCATOR__
  14. #define __LOCATOR__
  15.  
  16. /* Error Codes */
  17. #define toolNotFoundErr 0x0001
  18. #define funcNotFoundErr 0x0002
  19. #define sysStrtMtErr 0x0100        /* can't mount system startup volume */
  20. #define tlBadRecFlag 0x0103        /* StartStop record invalid */
  21. #define tlCantLoad 0x0104        /* A tool cannot be loaded */
  22. #define toolVersionErr 0x0110
  23. #define messNotFoundErr 0x0111
  24. #define messageOvfl 0x0112        /* No message numbers available */
  25. #define nameTooLong 0x0113        /* Message name too long */
  26. #define reqNotAccepted 0x0120    /* SendRequest request not accepted */
  27. #define duplicateName 0x0121    /* duplicate name for AcceptRequests */
  28. #define invalidSendRequest 0x0122 /* bad combo of target and sendHow */
  29.  
  30. /* MessageCenter Codes */
  31. #define fileInfoType 0x0001        /* Message type parameter */
  32. #define addMessage 0x0001        /* action parameter */
  33. #define getMessage 0x0002        /* action parameter */
  34. #define deleteMessage 0x0003    /* action parameter */
  35. #define fileInfoTypeGS 0x0011    /* Message type parameter (GS/OS strings) */
  36.  
  37. /* GetMsgHandle flags values */
  38. #define gmhByIndex 0
  39. #define gmhByType 1
  40. #define gmhByName 2
  41.  
  42. /* SendRequest/AcceptRequests codes */
  43. #define systemSaysBeep 0x0001    /* used by SysBeep2 */
  44. #define systemSaysUnknownDisk 0x0002 /* used by HandleDiskInsert */
  45. #define srqGoAway 0x0003
  46. #define srqGetrSoundSample 0x0004
  47. #define srqSynchronize 0x0005
  48. #define srqPlayrSoundSample 0x0006
  49. #define systemSaysNewDeskMsg 0x0008
  50. #define systemSaysEjectingDev 0x000E
  51. #define systemSaysDeskStartUp 0x0502
  52. #define systemSaysDeskShutDown 0x0503
  53. #define systemSaysFixedAppleMenu 0x051E
  54. #define systemSaysMenuKey 0x0F01
  55.  
  56. /* SendRequest sendHow values */
  57. #define stopAfterOne 0x8000
  58. #define sendToAll 0
  59. #define sendToName 1
  60. #define sendToUserID 2
  61.  
  62. /* StartUpTools flag bits */
  63. #define leaveScreenClean 0x0004
  64. #define openResAsAllowed 0x0008
  65. #define noResourceMgr 0x0010    /* for ShutDownTools, too */
  66.  
  67. /* TLMountVolume Codes */
  68. #define mvReturn 0x0001            /* like ok for dialogs */
  69. #define mvEscape 0x0002            /* like cancel for dialogs */
  70.  
  71. /* Tool Set Spec Codes */
  72. #define sysTool 0x0000
  73. #define userTool 0x8000
  74. #ifndef theToolsLength            /* ToolTable - default number of ToolSpecs */
  75. #define theToolsLength 0x0010
  76. #endif
  77.  
  78. struct MessageRec {
  79.     struct MessageRec **messageNext;
  80.     Word messageType;
  81.     Word messageData;
  82.     Str255 fileNames[1];
  83. } ;
  84. typedef struct MessageRec MessageRec, *MessageRecPtr, **MessageRecHndl;
  85.  
  86. typedef struct wString {
  87.     Word    length;                /* Number of Chars in text field  */
  88.     char    text[255];
  89. } wString, *wStringPtr, **wStringHndl;
  90. typedef wStringHndl *wStringHndlPtr;
  91.  
  92. typedef struct MessageRecGS {
  93.     long    reserved;    /* reserved */
  94.     Word    messageType;
  95.     Word    printFlag;
  96.     wString    fileNames[1];
  97. } MessageRecGS, *MessageRecGSPtr, **MessageRecGSHndl;
  98.  
  99. struct ToolSpec {
  100.     Word toolNumber;
  101.     Word minVersion;
  102. } ;
  103. typedef struct ToolSpec ToolSpec;
  104.  
  105. struct ToolTable {
  106.     Word toolCount;
  107.     ToolSpec theTools[theToolsLength];
  108. } ;
  109. typedef struct ToolTable ToolTable, *ToolTablePtr;
  110.  
  111. struct StartStopRecord {
  112.     Word flags;
  113.     Word videoMode;
  114.     Word resFileID;
  115.     Handle dPageHandle;
  116.     Word numTools;
  117.     ToolSpec theTools[theToolsLength];
  118. } ;
  119. typedef struct StartStopRecord StartStopRecord, *StartStopRecordPtr;
  120.  
  121. typedef Long ResponseRecord;
  122.  
  123. struct srqGoAwayOut {
  124.     Word recvCount;
  125.     Word resultID; /* returned UserID */
  126.     Word resultFlags; /* returned flags--bit 15=Restartable, 14-0=reserved */
  127. };
  128. typedef struct srqGoAwayOut srqGoAwayOut, *srqGoAwayOutPtr;
  129.  
  130. extern pascal Pointer GetFuncPtr() inline(0x0B01,dispatcher);
  131. extern pascal Pointer GetTSPtr() inline(0x0901,dispatcher);
  132. extern pascal Pointer GetWAP() inline(0x0C01,dispatcher);
  133. extern pascal void LoadOneTool() inline(0x0F01,dispatcher);
  134. extern pascal void LoadTools() inline(0x0E01,dispatcher);
  135. extern pascal ResponseRecord MessageByName() inline(0x1701,dispatcher);
  136. extern pascal void MessageCenter() inline(0x1501,dispatcher);
  137. extern pascal void RestoreTextState() inline(0x1401,dispatcher);
  138. extern pascal Handle SaveTextState();
  139. extern pascal void SetDefaultTPT() inline(0x1601,dispatcher);
  140. extern pascal void SetTSPtr() inline(0x0A01,dispatcher);
  141. extern pascal void SetWAP() inline(0x0D01,dispatcher);
  142. extern pascal void ShutDownTools() inline(0x1901,dispatcher);
  143. extern pascal Ref StartUpTools() inline(0x1801,dispatcher);
  144. extern pascal void TLBootInit() inline(0x0101,dispatcher);
  145. extern pascal Word TLMountVolume() inline(0x1101,dispatcher);
  146. extern pascal void TLReset() inline(0x0501,dispatcher);
  147. extern pascal void TLShutDown() inline(0x0301,dispatcher);
  148. extern pascal void TLStartUp() inline(0x0201,dispatcher);
  149. extern pascal Boolean TLStatus() inline(0x0601,dispatcher);
  150. extern pascal Word TLTextMountVolume() inline(0x1201,dispatcher);
  151. extern pascal Word TLVersion() inline(0x0401,dispatcher);
  152. extern pascal void UnloadOneTool() inline(0x1001,dispatcher);
  153.  
  154. extern pascal Handle GetMsgHandle() inline(0x1A01,dispatcher);
  155. extern pascal void AcceptRequests() inline(0x1B01,dispatcher);
  156. extern pascal void SendRequest() inline(0x1C01,dispatcher);
  157. #endif
  158.